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PREFACE 

This instant provides a convenient summary of the 
Control Data® Sort/Merge Version 5.0 utility, which 
operates under the control of the NOS 2 and NOS/BE 1 
operating systems for the CDC ® CYBER 170 Computer 
Systems. 

This Instant asstimes that you are an application 
programmer familiar with Sort/Merge and the operating 
system that you use. If you use procedure calls to 
Sort/Merge, the Instant assumes that you are familiar 
with the calling language. 

You can find related information in the publications 
listed below; the publications are listed within 
groupings that Indicate relative importance to you. 

The NOS manual abstracts and the NOS/BE manual 
abstracts are pocket-sized manuals containing brief 
descriptions of the contents and Intended audience of 
all NOS and NOS/BE manuals and NOS and NOS/BE product 
set manuals. The manual abstracts can be useful in 
determining which manuals are of greatest interest to 
you. The Software Publications Release History serves 
as a guide in determining which revision level of 
software documentation corresponds to the Programming 
System Report (PSR) level of software installed at your" 
site. 



The following manuals are of primary interest! 



Publication 

Publication Number 

COBOL Version 5 Reference Manual 60497100 

CYBER Record Manager 60495700 
Basic Acess Methods Version 1.5 
Reference Manual 

FORTRAN Version 5 Reference Manual 60481300 

Sort/Merge Version 5 Reference 

Manual 60484800 
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The following manuals are of secondary interest: 

Publication 
Publication Number 

INTERCOM Version 5 Reference Manual 60455010 

Network Products 60459330 

Interactive Facility Version 1 
Reference Manual 

Network Products 60499600 

Remote Batch Facility Version 1 
Reference Manual 

NOS Version 2 Manual Abstracts 60485500 

NOS Version 2 Reference Set, 60459680 
Volume 3 System Commands 

NOS/BE Version 1 Manual Abstracts 84000470 

NOS/BE Version 1 Reference Manual 60493800 

Software Publications Release 

History 60481000 



CDC manuals can be ordered from Control Data 

Corporation, Literature and Distribution 

Services, 308 North Dale Street, St. Paul, 
Minnesota 55103. 



This manual describes a subset of the 
features and parameters docxamented in 
the Sort/Merge Version 5 Reference 
Manual, Control Data cannot be 
responsible for the proper functioning 
of any features or parameters not 
documented in the Sort/Merge Version 5 
Reference Manual. 
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NOTATIONS 

Unless otherwise specified, the conventions described 
in the following paragraphs are used throughout this 
manual in parameter and procedure call formats. 

UPPERCASE Uppercase letters indicate words, 
acronyms , or mnemonics required as 
input by Sort/Merge. Parameter 
keywords and interactive commands are 
included in this category. 



[ ] 



Lowercase letters indicate words or 
symbols that you must supply. 

Ellipses indicate that omitted entities 
repeat the form and function of the 
last entity given. 

Brackets indicate an optional portion 
of a parameter or procedure call format. 

Two periods in a parameter format 
indicate a range of letters or digits. 
The periods are part of the syntax and 
must be written where shown. 



The delta symbol represents 
used as a separator . 



a blank 



Unless otherwise indicated, all numbers in text are 
decimal values . 
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INTRODUCTION 

Sort/Merge Version 5 is a set of powerful and efficient 
routines that provides high-speed sorting or merging of 
records for batch processing or Interactive proc- 
essing. This section Introduces the available features 
and the default CYBER Record Manager (CRM) file 
characteristics for Sort/Merge. 



FEATURES 

Sort/Merge offers the following features: 

• A sort or merge specification with a single control 
statement. Using the SORT control statement, 
records are rearranged into the order you specify. 
Using the MERGE control statement, two or more 
sorted files are combined into one file. 

• An optional directive file for sort or merge 
specification 

• The capability of sorting or merging records from 
as many as 100 files with one call to Sort/Merge 



• 



Character and noncharacter sort key types 

• Five predefined collating sequences 

• User-defined collating sequences 

• The capability of summing numeric fields 

• The capability of sorting any CRM sequential file 
and any record type (except U) 

• A tutorial dialog for interactive sort or merge 
specification 

• A set of procedures for sort or merge processing 
from within a program written In FORTRAN, COBOL, or 
some other languages 

• Owncode routines to insert, substitute, modify, or 
delete records during Sort/Merge processing 
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FILE CHARACTERISTICS 

Sort/Merge uses the CRM file processing and 

input/output capabilities. The default file 

characteristics specified by CRM apply to all 

Sort/Merge input and output data files, unless this 
instant indicates otherwise. 

The file organization must be sequential. The default 
file characteristics are BT=C, RT-Z, FL (or MRL)=150. 
Other file characteristics can be set by the FILE 
control statement. 
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SORT KEYiS 

A sort key Is a field of data within each record In 
either an Input file to be sorted or In a presorted 
file to be merged with one or more other files. The 
key determines the order In which records are output. | 
Key fields must occur in the same position and be the 
same length in all records. The total number of key 
characters must be less than 256 (If you also specify 
sum fields, the total number of characters In the key 
and sum fields together must be less than 256). The 
key and sum fields must not overlap. 

A file can be sorted on more than one key. The first 
key you specify is the major sort key and the following 
keys are minor sort keys . 

KEY STARTING LOCATION 
AND LENGTH 

You define the starting location of the sort key by 
specifying the first byte or bit of the field . Specify 
the length of the sort key by the number of bytes or 
bits in the field, or by the last byte or bit of the 
field. The leftmost byte or bit In a record is counted 
as number 1. For character data, each character is six 
bits and occupies one byte. Specify the sort key 
location and length with the KEY parameter or SM5KEY 
procedure call parameter. 

TYPE OF DATA 

You specify the type of data in a key field with a 
collating sequence for character data or a numeric data 
format for numeric or noncharacter data. Table 1 
summarizes character and noncharacter data types and 
the associated sort key type. 



COLLATING SEQUENCE 

To determine character precedence for alphanumeric 
data, specify one of the predefined collating sequences 
or define your own collating sequence. Choose the 
collating sequence with the KEY parameter or SM5KEY 
procedure call. The data must be display code 
characters. The predefined collating sequences are 
ASCII6, C0B0L6, DISPLAY, EBCDIC6, or INTBCD. Table 2 
shows these predefined collating sequences. The 
default is ASCII6. See the Sort/Merge reference manual 
for a description of these collating sequences. 
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TABLE 1. DATA IN SORT KEY FIELDS 



Type 


Internal 
Representation 


Data 
in Field 


Type 
Specified by 


Data Ordered 
According to 


Character 


Display code 


Alphabetic 


Name of a collating 
sequence 


Specified 
collating 
sequence 


Numeric 


Name of a collating 
sequence 


Specified 
collating 
sequence 


Name of a numeric 
data format 


Numeric 
value 


Noncharacter 


Binary value 


Numeric 


Name of a numeric 
data format 


Numeric 
value 



TABLE 2. PREDEFINED COLLATING SEQUENCES 



Collating 
Sequence 


ASCI 16 


C0B0L6 


DISPLAY 


EBCDIC6 


INTBCD 


Decimal 


Octal 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


CDC 

INTBCD 

Code 


00 
01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 


00 
01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 

14 : 

15 
16 
17 
20 
21 
22 
23 


blank 
! 

# 

i 

+ 

/ 



1 

2 
3 


55 
66 
64 
60 

67 
70 
51 
52 
47 
45 
56 
46 
57 
50 
33 
34 
35 
35 


blank 

ft 
[ 

-♦ 
/■s 

t 

> 
> 

') 

+ 

$ 

* 

/ 


55 

63t 

61 

65 

60 

67 

70 

71 

73 

75 

76 

57 

52 

77 

45 

53 

47 

46 

50 


:t 

A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 

P 
Q 
R 
S 


00 
01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 


blank 

< 
( 

+ 

1 
& 

$ 

■k 

) 

/ 
«t 

> 

? 


55 

57 

72 

51 

45 

66 

67 

53 

47 

52 

77 

76 

46 

50 

56 

63t 

65 

73 

71 

00 



1 
2 
3 
4 
5 
6 
7 
8 
9 

# 

< 

% 

[ 
+ 

A 

B 

C 


00 
01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 



TABLE 2. PREDEFINED COLLATING SEQUENCES (Contd) 



Collating 
Sequence 


ASCIIS 


C0B0L6 


DISPLAY 


EBCDIC6 


INTBCD 


Decimal 


Octal 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


Display 
Code 


Graphics 


CDC 

INTBCD 
Code 


20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 


24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 


4 
5 
6 
7 
8 

< 

> 

? 

A 
B 
C 
D 
E 
F 


37 
40 
41 
42 
43 
44 
00 
77 
72 
54 
73 
71 
74 
01 
02 
03 
04 
05 
06 


{ 

< 
A 
B 
C 
D 
E 
F 
G 
H 
I 

V 

J 

K 

L 
M 


56 
51 
54 
64 
72 
01 
02 
03 
04 
05 
06 
07 
10 
11 
65 
12 
13 
14 
15 


T 
U 
V 

w 

X 
Y 

z 



1 

2 
3 
4 
5 
6 
7 

a 

9 
+ 


24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
46 
46 


# 
i 

A 
B 
C 
D 
E 
F 
G 
H 
I 
1 
J 
K 
L 


60 
74 
70 
54 
64 
61 
01 
02 
03 
04 
05 
06 
07 
10 
11 
62 
12 
13 
14 


D 
E 
F 
G 
H 
I 
< 

) 

> 
—I 

J 
K 
L 
M 
N 



24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 



39 


47 


G 


07 


N 


16 


* 


47 


M 


15 


P 


47 


40 


50 


H 


10 





17 


/ 


50 


N 


16 


Q 


50 


41 


51 


I 


11 


P 


20 


( 


51 





17 


R 


51 


42 


52 


J 


12 


Q 


21 


) 


52 


P 


20 


V 


52 


43 


53 


K 


13 


R 


22 


$ 


53 


Q 


21 


$ 


53 


44 


54 


L 


14 


] 


62 


= 


54 


R 


22 


* 


54 


45 


55 


M 


15 


S 


23 


blank 


55 


none 


75 


t 


55 


46 


56 


N 


16 


T 


24 


, 


56 


S 


23 


i 


56 


47 


57 





17 


U 


25 


. 


57 


T 


24 


> 


57 


48 


60 


P 


20 


V 


26 




60 


U 


25 


blank 


60 


49 


61 


Q 


21 


w 


27 


r 


61 


V 


26 


/ 


61 


50 


62 


R 


22 


X 


30 


h 


62* 


u 


27 


S 


62 . 


51 


63 


S 


23 


Y 


31 


63t 


X 


30 


T 


63 


52 


64 


T 


24 


Z 


32 


*■ 


64 


Y 


31 


L) 


64 


53 


65 


U 


25 




00 


-» 


65 


Z 


32 


V 


65 


54 


66 


V 


26 


6 


33 


V 


66 





33 


w 


66 


55 


67 


w 


27 


1 


34 


/\ 


67 


1 


34 


X 


67 


56 


70 


X 


30 


2 


35 


t 


70 


2 


35 


Y 


70 


57 


71 


Y 


31 


3 


36 


\ 


71 


3 


36 


z 


71 


58 


72 


Z 


32 


4 


37 


< 


72 


4 


37 


] 


72 


59 


73 


[ 


61 


5 


40 


> 


73 


5 


40 




73 


60 


74 


\ 


75 


6 


41 


< 


74 


6 


41 


( 


74 


61 


75 


1 


62 


7 


42 


> 


75 


7 


42 


-* 


75 


62 


76 


/^^ 


76 


8 


43 


—, 


76 


8 


43 


= 


76 


63 


77 




65 


9 


44 


' 


77 


9 


44 


^ 


77 


tini 


nstallations usinc 


a 63-graphic set. 


the % graphic does not exist 


The : graphic is 


display code 53. 



You can define your own collating sequence with the 
SEQx parameters in the SORTS or MERGE control statement 
or with SMSSEQx procedure calls. See the sections on 
the SEQx parameters and the SMSSEQx procedure calls for 
more details. 



NUMERIC DATA FORMAT 

You can use numeric data in one of the formats shown In 
table 3, Numeric data can be signed or unsigned. For 
character numeric data that is signed » the sign can be 
a floating sign, a leading or trailing separate 
character, or an over punch representation over the 
leading or trailing digit. Table 4 shows the input and 
output representation of a sign overpunch for numeric 
data. See the Sort/Merge S reference manual for 
details about these sign types. 

You define numeric key fields by specifying the first 
byte of the field and either the length of the field or 
the last byte of the field. For types BINARY__BITS and 
INTEGER_BITS , specify the first bit position of the 
field and either the length of the field in bits or the 
last bit of the field. 



SORT ORDER 

The sort order for keys is ascending or descending. 
Ascending order for numeric keys places the record with 
the largest key value last. Ascending order for 
character keys uses the order of the collating 
sequence. Descending order for numeric keys places the 
record with the largest key value first. Descending 
order for character keys uses the reverse order of the 
collating sequence. The defaixlt sort order is 
ascending . 
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TABLE 3. NUMERIC DATA FORMATS 



Name 


Data Type 


Sign 


Comments 


NUMERIC LO 


Numeric characters 


Leading overpunch 


All characters are decimal digits except the 








leading character, which indicates a sign by 
an overpunch. Data is ordered according to 
numeric value with all forms of zero ordered 
equally. 


NUMERIC LS 


Numeric characters 


Leading separate 


All characters are decimal digits except the 








leading character, which is a negative or 
positive sign. Specifying a field that is 
not at least two characters in length causes 
a fatal error. Data is ordered according to 
numeric value with all forms of zero ordered 
equally . 


NUMERIC TO 


Numeric characters 


Trailing overpunch 


All characters are decimal digits except the 








trailing character, which indicates a sign 
by an overpunch. Data is ordered according 
to numeric value with all forms of zero 
ordered equally. 



TABLE 3. NUMERIC DATA FORMATS (Contd) 



Data Type 



Sign 



Comments 



NUMERIC TS 



Numeric characters 



Trailing separate 



NUMERIC NS 



NUMERIC FS 



Numeric characters 



Leading blanks , 
numeric characters 



- sign for negative 
values; a + character 
Is not allowed 



All characters are decimal digits except the 
trailing character, which is a negative or 
positive sign. Specifying a field that is 
not at least two characters in length causes 
a fatal error. Data is ordered according to 
numeric value with all forms of zero ordered 
equally. 



All characters are decimal digits, 
ordered according to numeric value. 



Data is 



The field contains leading blanks (leading 
zeros must be converted to blanks); if the 
value is negative, the right-most leading 
blank must be converted to a minus sign. If 
the field contains no leading blanks, the 
value must be positive. This format is 
equivalent to the FORTRAN I format. Data is 
ordered according to numeric value. 



BINARY 


Binary integer 


None 


The field starts and ends on character 
boundaries. Data is ordered according to 
numeric value. 


BINARY_BITS 


Binary integer 


None 


The field does not start or end on character 
boundaries. Data is ordered according to 
numeric value. 


INTEGER 


One ' s complement 
binary integer 


Positive if leftmost 
bit is 0; negative if 
leftmost bit is 1 


The field starts and ends on character 
boundaries. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 


1NTEGER_B1TS 


One's complement 
binary integer 


Positive if leftmost 
bit is 0; negative if 
leftmost bit is 1 


The field does not start or end on character 
boundaries. Data is ordered according to 
numeric value with negative zero ordered 
before positive zero. 


REAL 


Normalized binary 
real or floating- 
point number 


Signed 


The field occupies a full computer word and 
is aligned on word boundaries. Data is 
ordered according to numeric value with all 
forms of zero ordered equally. The order of 
indefinite values is undefined. 



TABLE 4. SIGN OVERPUNCH REPFESENTATION 



Sign and 
Digit 


Input 
Punch 


Output 
Representation 


+9 


12-9 


I 


+8 


12-8 


H 


+7 


12-7 


G 


+6 


12-6 


F ' 


+5 


12-5 


E 


+4 


12-4 


D 


+3 


12-3 


C 


+2 


12-2 


B 


+1 


12-1 


A 


+0 


12-0 


[t 


-0 


11-0 


]t 


-1 


11-1 


J 


-2 


11-2 


K 


-3 


U-3 


L 


-4 


11-4 


M 


-5 


11-5 


N 


-6 


11-6 





-7 


11-7 


P 


-8 


11-8 


Q 


-9 


U-9 


R 


tValld on NOS with 029 keypunches. ( 
See a character set table for NOS/BE 
representations of +0 and -0, 



12 
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CONTROL STATEMENT 
SORTS OR MERGES 

The control statements SORTS and MERGE are used to 
initiate the processing of your files. These 
statements use parameters and/or directive files to 
direct the processing. The following paragraphs define 
the format and usage of the control statements, 
parameters, and directive file statements. 

SORTS 

SORTS initiates the Sort/Merge sort capabilities. In 
interactive mode, control statements cannot be 
continued on more than one line. In batch mode, you 
can continue the control statement line by placing two 
or more periods at the end of the line and one period 
at the beginning of the new line. You can only 
continue lines that are not ranges. You can use a 
maximxim of 240 characters; the maximum processed per 
line is 80, The control statement begins with the word 
SORTS, which must be followed by a period. The SORTS 
control statement format is shown below: 

SORTS. pi, p2,...,pn 

p Processing parameters; separators must 

be commas or spaces , which can be used 
interchangeably 

MERGE 

MERGE initiates Sort/Merge merge capabilities. In 
interactive mode, control statements cannot be 
continued on more than one line. In batch mode , you 
can continue the control statement line by placing two 
or more periods at the end of the line and one period 
at the beginning of the new line , You can use a 
maximum of 240 characters for the line and 
continuation; the maximum number of characters 
processed per line Is 80. The control statement begins 
with the word MERGE, which must be followed by a 
period. The format for MERGE is shown below: 

MERGE. pi, p2,,,,,pn 

p Processing parameters; separators must 

be commas or spaces, which can be used 
interchangeably 
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DIRECTIVE FILES 

You can use directive files for more complex sorts or 
merges and for standardizing installation parameters 
and collating sequences. A directive file contains 
processing parameters and parameters in the SORT or 
MERGE control statements. 

Specify directive files with the DIR parameter in the 
SORTS or MERGE control statement. The directive file 
statement formats are: 

SORT, pi, p2,.. .,pn 

MERGEA plA p2A . .. Apn 

p Processing parameter; separators must 

be commas or spaces, which can be used 
interchangeably 

You can continue the directive file statement by 
placing two or more periods at the end of the line and 
one or more spaces at the beginning of the new line. 
The directive files must be BT=C, RT=Z, and FL=100 or 
less. Characters in excess of 80 are ignored. 

ALPHABETIZED LIST OF 
PARAMETERS 

You can specify the parameters in the SORTS or MERGE 
control statement or directive file to direct 
processing. However, the DIALOG parameter cannot 
appear in a directive file. When specified with 
keywords, parameters take one of the following forms, 
depending on the parameter: 

keyword=( ( value-set )[ , (value-set)] ., .) 

keyword =value 

The value or value-set is defined in the individual 
parameter descriptions. You can delete the keyword by 
supplying a value or value-set in the position assigned 
to that particular keyword. 

You can mix keyword and positional specifications of 
parameters. See the Sort/Merge 5 reference manual for 
more information. Table 5 lists the parameter keywords 
and the position assigned to each. 
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CONTROL STATEMENT 
SORTS OR MERGES 

The control statements SORTS and MERGE are used to 
initiate the processing of your files. These 
statements use parameters and/or directive files to 
direct the processing. The following paragraphs define 
the format and usage of the control statements, 
parameters, and directive file statements. 

SORTS 

SORTS initiates the Sort/Merge sort capabilities. In 
intera.ctlve mode, control statements cannot be 
continued on more than one line. In batch mode, you 
can continue the control statement line by placing two 
or more periods at the end of the line and one period 
at the beginning of the new line , You can only 
continue lines that are not ranges. You can use a 
maximum of 240 characters; the maximimi processed per 
line Is 80. The control statement begins with the word 
SORTS, which must be followed by a period. The SORTS 
control statement format is shown below: 

SORTS, pi, p2,..,,pn 

p Processing parameters; separators must 

be commas or spaces , which can be used 
interchangeably 

MERGE 

MERGE initiates Sort/Merge merge capabilities. In 
interactive mode, control statements cannot be 
continued on more than one line. In batch mode, you 
can continue the control statement line by placing two 
or more periods at the end of the line and one period 
at the beginning of the new line . You can use a 
maximum of 240 characters for the line and 
continuation; the maximum number of characters 
processed per line is 80. The control statement begins 
with the word MERGE , which must be followed by a 
period. The format for MERGE is shown below: 

MERGE.pl ,p2 , . . . ,pn 

p Processing parameters ; separators must 

be commas or spaces, which can be used 
interchangeably 
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DIRECTIVE FILES 

You can use directive files for more complex sorts or 
merges and for standardizing Installation parameters 
and collating sequences. A directive file contains 
processing parameters and parameters in the SORT or 
MERGE control statements. 

Specify directive files with the DIR parameter in the 
SORTS or MERGE control statement. The directive file 
statement formats are: 

S0RT,pl,p2,...,pn 

MERGEA plA p2A .... Apn 

p Processing parameter; separators must 

be commas or spaces , which can be used 
interchangeably 

You can continue the directive file statement by 
placing two or more periods at the end of the line and 
one or more spaces at the beginning of the new line. 
The directive files must be BT=C, RT=Z, and FL=100 or 
less. Characters in excess of 80 are ignored. 

ALPHABETIZED LIST OF 
PARAMETERS 

You can specify the parameters in the SORTS or MERGE 
control statement or directive file to direct 
processing. However, the DIALOG parameter cannot 
appear in a directive file. When specified with 
keywords, parameters take one of the following forms, 
depending on the parameter: 

keyword=( ( value-set )[ , (value-set ) ] ,..) 

keyword=value 

The value or value-set is defined in the individual 
parameter descriptions. You can delete the keyword by 
supplying a value or value-set in the position assigned 
to that particular keyword. 

You can mix keyword and positional specifications of 
parameters. See the Sort/Merge 5 reference manual for 
more information. Table 5 lists the parameter keywords 
and the position assigned to each. 
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EL 

The EL parameter specifies the error level to be 
reported. The default Is EL=W. The EL parameter format 
is shown below: 



EL=el 



The error level can be : 

T for trivial (Includes W, F, and C), 
W for warning (Includes F and C) , 
F for fatal (Includes C) , or 
C for catastrophic. 



ENR 



The ENR parameter specifies the estimated number of 
records to be sorted or merged. The number can be a 
single value or a range of values. If you omit ENR, a 
value of 80000 divided by the value specified for the 
maximum record length (MEL) is used. The ENR parameter 
format is shown below: 

ENK=expr 

ENR-expr..expr 

expr Expression that is a decimal integer 
or CYBER Control Language (CCL) 
variable Rl , R2, R3, RIG, EF, or EFG. 



FASTIO 

The FASTIO parameter specifies that certain sort or 
merge input and output operations are to be performed 
directly by Sort/Merge rather than by CVBER Record 
Manager (CRM). Specifying the FASTIO parameter results 
in increased speed, but not all errors are diagnosed. 
FASTIO-YES Indicates that files are read or written by 
Sort/Merge. The records must be CRM format BT=C and 
RT^F, or BT=I and RT=W. Other block and record types 
are processed using CRM. FASTIO=NO Indicates that the 
files are processed using CRM. Omitting the FASTIO 
parameter is equivalent to FASTIO=NO. The FASTIO 
parameter format is shown below: 

FASTIO'YES (or FASTIO=Y) 

FASTIO=NO (or FASTXO=N) 
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FROM 

The FROM parameter specifies the input files from which 
the records to be sorted or merged are read. As many 
as 100 files can be sorted or merged in one job step. 
If you omit the FROM parameter, records are read from 
file OLD (unless an owncode routine supplies records). 
The FROM parameter format is shown below: 

FROM=lfn 

FROM=(lfnl ,lfn2». . . »lfnn) 

FROM=$NULL 

Ifn Logical file name; one to seven 
letters or digits, beginning with a 
letter. 

$NULL Records are not read from a file; they 
must be supplied from an owncode 
routine. 



KEY 

The KEY parameter specifies the key fields that 
determine the sorted or merged order of output 
records. The total number of key characters must be 
less than 256 ( if you also specify sum fields , the 
total number of characters in the key and sum fields 
together must be less than 256). The three KEY 
parameter formats are shown below: 

KEY=( (value-set ) [ , (value-set) ] . . . ) 

KEY=first..last 

KEY=first 

value-set (first[ ,length[ ,type[,ad] ] ]) or 
( f irst., last [, type [, ad]]) 

first First byte or bit of the key field 

length Number of bytes or bits in the key 
field; default is 1 

last Last byte or bit of the key field 
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type Name of a numeric data format or 
collating sequence; default is ASCII6 

ad Order; either A for ascending or D for 

descending; default is A 

Two sets of parentheses are still needed if you specify 
only one key field with the first format. If you omit 
the KEY parameter, KEY=l...mnr (minimum record length) 
is used* 



The L parameter specifies the file to which listing 
information is written. The default value is L=OUTPUT» 
which lists information to the file OUTPUT. The L 
parameter format is shown below: 

L=lfn 

L=$NULL 

Ifn Logical file name; one to seven 
letters or digits, beginning with a 
letter. 

$NULL Listing Information is not written. 

LO 

The LO parameter selects the listing options. Omitting 
the LO parameter is equivalent to LO=S. The format for 
the LO parameter and the possible options are shown 
below: 

LO=optlon 

option You can select one of the following 
options: 

S A copy of the directive file is 
written. 

A A copy of the resource map is written. 

(S,A) A copy of the directive file and the 
or (A,S) resource map is written. 

OFF Nothing is written. 
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OWNF 

The OWNF parameter specifies the file that is the 
source of owncode routines. If the owncode routine is 
not on the file specified by OWNF, the global library 
set is searched. The OWNF parameter format is shown 
below: 

OWNF-lfn 

Ifn Logical file name; one to seven 
letters or digits, beginning with a 
letter. 



OWNFL 

The OWNFL parameter specifies the exact nxjmber of 
characters in all records entering the sort from an 
owncode routine. You cannot specify both the OWNFL and 
OWNMRL parameters for the same sort . The OWNFL 
parameter format is shown below: 

OWNFL=integer (or OFL=integer) 

integer Integer from 1 to 5000 (larger records 
can be sorted if the field length is 
increased). The default is the record 
length specification of the input and 
output files. 



OWNMRL 

The OWNMRL parameter specifies the maximum length in 
characters of any record entering the sort from an 
owncode routine. You cannot specify both the OWNFL and 
OWNMRL parameters for the same sort . The OWNMRL 
parameter format is shown below: 

OWNMRL=integer (or OMRL=lnteger) 

integer Integer from 1 to 5000 (larger records 
can be sorted If the field length Is 
Increased). The default Is the length 
specification of the Input and output 
files. 
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OWNn 

The OWNn parameter specifies the name of an ovmcode 
procedure that is executed each time point n is reached 
during the sort or merge. The owncode routine named 
must be In the OWNF file or be In the global library 
set. The OWNn parameter format is shown below: 



OWNn=proc 



Point in Sort/Merge processing at 
which the owncode routine is executed; 
must be a 1, 2, 3, 4, or 5. See the 
section on Owncode Routines for more 
detailed information. 

Procedure name; 1 to 31 letters, 
digits, or the special characters ? # 

@ , Only seven characters are 

significant and the first must be a 
letter. 



RETAIN 

The RETAIN parameter (RETAIN=YES) directs Sort/Merge to 
output records with equal sort keys in the same order 
as the records are input. RETAIN=NO or not specifying 
the parameter might cause records with equal sort keys 
to be output in a different order than the records are 
input. Omitting the RETAIN parameter is equivalent to 
RET=N. The RETAIN parameter format is shown below: 

RETAIN=YES (or RET-Y) 

RETAIN=NO (or RET-N) 
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SEQx 

The SEQx parameters define your own collating 
sequence. The SEQN signals the start of your sequence 
definition. The definition of one collating sequence 
continues with the SEQS, SEQR, or SEQA parameters; it 
is terminated by any parameter other than these three. 
You can define as many as 100 collating sequences with 
a separate series of SEQx parameters. The SEQx 
parameter formats for each collating sequence are shown 
below: 

SEQN=name 

SEQS=('char' ,.../char') 



[SEQR=YES or SEQR=Y] 
[SEQA=YES or SEQA=Y] 

SEQN This parameter specifies that the name 
of the collating sequence will be 
'name' . 'Name' cannot be the same 
name as a standard collating sequence 
or a previous user-defined name . 
'Name' must be 1 to 31 letters, 
digits , or the special characters ? # 
@ _ ; only ten characters are 
significant and the first must be a 
letter. 

SEQS This parameter specifies the collating 
positions of the characters in your 
collating sequence. Each SEQS 
parameter specifies either a single 
step or a range of steps, indicated by 
' char ' . As ingle character may be 
specified by the character enclosed in 
apostrophes, or by $CHAE.(n) , where n 
is the number of the character in your 
character set . You can specify the 
SEQS parameter more than once in a 
directive file. 

SEQR This parameter defines a special value 
step that consists of all characters 
not explicitly or implicitly specified 
with SEQS; either YES or Y is 
allowed. This parameter can appear 
once in any place between the start 
and end of the sequence definition. 
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SEQA This parameter alters all equated 
characters in output records so they 
become the first characters in the 
appropriate SEQS parameter. Either 
YES or Y is allowed . This parameter 
can appear once in any place between 
the start and end of the sequence 
definition. 



STATUS 

The STATUS parameter specifies that a CYBER Control 
Language (CCL) variable be set to a value representing 
the highest level of error that occurred during the 
sort or merge. The values that can be returned In the 
specified variable are shown in table 6. This 
parameter prevents an abort if a fatal or catastrophic 
error occurs before any data records are input. Some 
types of execution errors do not allow recovery and an 
abort can occur regardless of the STATUS parameter. 
The STATUS parameter format is shown below: 

STATUS=variable (or ST=variable) 

variable CCL variable Rl, R2, R3, RIG, EF, or 
EFG 



TABLE 6. ERROR LEVEL CODES, STATUS PARAMETER 



Error Level 


Code 




No errors 







Trivial 


20 




Warning 


30 




Fatal 


40 




Catastrophic 


50 





SUM 

The SUM parameter specifies the fields that you want to 
combine from records with equal key values. As many as 
255 bytes can be summed. The records with all key 
fields equal are combined into one new record, and the 
other records with equal keys are deleted. Sum fields 
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cannot be key fields. See the Sort/Merge 5 reference 
manual for further details about the summing 
algorithm. The SUM parameter format is shown below: 

SUM=((value-set )[, (value-set) ],.. ) 

(value-set) (first, length, type[ , rep]) or 
(first . . last , type [ , rep] ) 

first First byte or bit of the sum field 

length Number of bytes or bits in the sum 
field 



last 



Last byte (or bit for formats 
BINARY_BITS and INTEGER_BITS ) in the 
sum field 



type 



Name of a numeric data format (except 
REAL) 



Nximber of adjacent fields to be 
summed; default is 1 



TO 

The TO parameter specifies the file to which sorted or 
merged records are written. If you omit the TO 
parameter, records are written to the file NEW (if 
there is not an owncode routine to process records). 
The TO parameter format Is shown below: 

TO=lfn Logical file name; one to seven 
letters or digits , beginning with a 
letter. 



TO=$NULL 



Records are not written to a file; you 
must supply an owncode routine. 



VERIFY 

The VERIFY parameter directs Sort /Merge to check merge 
input records for correct order. If a record is out of 
order when you have specified VERIFY=YES, the merge is 
aborted, even if the STATUS parameter has been 
specified, A dayfile message is then issued 
identifying the file that is out of order. If you 
specify VERIFY=NO or omit the VERIFY parameter, merge 
input records are not checked for correct order. The 
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VERIFY parameter cannot be used for a sort. Omitting 
the VERIFY parameter Is equivalent to VERIFY-NO. The 
VERIFY parameter format Is shown below: 



VERIFY=YES 
VERIFY=NO 



(or VER-Y) 
(or VER=N) 



CYBER RECORD MANAGER FILE 
CONTROL STATEMENT 

The CYBER Record Manager (CRM) FILE control statement 
specifies the characteristics of all Input and output 
data files named In a SORTS or MERGE control statement, 
or in a directive file. You must specify the FILE 
control statement before the S0RT5 or MERGE control 
statements for files with other than default 
characteristics. 

The defaults are automatic for files INPUT, OUTPUT, and 
PUNCH. The record length must be supplied if the 
default does not apply to the file. The default file 
characteristics that apply to some different file types 
are shown in table 7. 



TABLE 7. FILE CHARACTERISTICS 



File 


Fit Field 


BT 


RT 


FL 


FROM files 
TO file 
DIR files 
L file 
E file 
INPUT 
OUTPUT 
. PUNCH 


C 
C 
C 
C 
C 
C 
C 
C 


Z 
Z 
_Z 
Z 
Z 
Z 
Z 
Z 


FL<150 

FL<150 

FLU 00 

FL-132 

FL=72''' 

FL=80 

PL*140 

FL-80 


^If E-OUTPUT, FL=140 is used. 
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INTERACTIVE USE 

You can access Sort /Merge from your terminal by 

specifying parameters Interactively or by using an 

Interactive dialog. After you connect your terminal to 
the computer you can use either interactive method. 



INTERACTIVE DIALOG 

The DIALOG=YES invokes a dialog between you and 
Sort/Merge for sort or merge specification. You can 
specify owncode routines and a nonstandard collating 
sequence. Before beginning the dialog you must assign 
files to be used and enter CTIM FILE control statements 
for any files not written In standard unit record 
format. Standard unit record format files Include 
files created by punched cards in a batch job or lines 
entered at a terminal, and the special files INPUT, 
OUTPUT, and PUNCH. 

During the dialog you are asked questions. Your 
response to a question determines the next question. 
For answers requiring YES or NO, you can use Y or N. 
When you have completed the dialog, the following 
message Is displayed: 

THANK YOU. SORT/MERGE NOW BEGINS. 

If sorted or merged records are written to a file (not 
processed by an owncode routine), Sort/Merge creates a 
local file and gives this file the output name that you 
specified during the dialog. When the dialog is 
complete, you can display or print this local file at 
the terminal, you can route this file to a printer, or 
you can save the file. 

INTERACTIVE PARAMETERS 
AND COMMANDS 

You can use all Sort/Merge parameters at your terminal 
with the same SORTS or MERGE control statement 
requirements as used In batch processing. You must 
first login, BEQUEST and ATTACH all necessary files, 
and type in any needed FILE control statements. 

You can use the commands HELP, RESTART, and QUIT to 
control the use of the interactive dialog. These 
commands can be used at any time during the interactive 
dialog. Table 8 lists the interactive commands and 
their uses. 
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TABLE' 8 i INTERACTIVE CpMMANDS 



Command 


Usage 


HELP 

RESTART 

QUIT 


Displays explanation, of Sort/ 
Merge usage. 

Restarts Interactive dialog at 
beginning. 

Terminates interactive dialog. 
Control returns to the oper- 
ating system. 
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PROCEDURE CALLS 

You can invoke a sort or merge from within a program by 
a sequence of procedure calls. You can call the 
procedures from a FORTRAN program or from a program in 
any language that uses the standard FORTRAN calling 
sequence, such as COBOL. 

To use procedure calls you must observe all coding 
conventions for the language, and assign any needed 
permanent files. The default file characteristics are 
used unless you use the FILE control statement. 

You can call the procedures in any order, except you 
must call SH5S0RT or SM5MERG first, and you must call 
SM5END last. Since there are no default values, all of 
the parameters in the following call statements must be 
included . 



SM5E 

The SM5E procedure specifies the file to which 
diagnostic messages are written. The file Is written 

in CRM format BT=C, RT==Z, and FL-72. If you do not 
call SM5E, diagnostic messages are written to file 
OUTPUT. If you specify file $NULL, no diagnostic 
messages are written. The SM5E procedure format Is 
shown below: 

CALL SM5E('file') 

'file' File name; one to seven letters or 
digits, beginning with a letter. 



SM5EL 

The SM5EL procedure specifies the error level to be 
reported. If you do not call SM5EL, errors of levels 
T, W, F, and C are reported. Errors are written to the 
file specified by SM5E, or to OUTPUT if you do not call 
SM5&. The SM5EL procedure format is shown below: 

CALL SM5EL (error-level) 

error-level Alphabetic character enclosed in 
apostrophes or an integer as shown in 
table 9. 
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TABLE ?. ERROR LEVEL SPECIFICATION 



Error Level 


Errors Reported 


'T' or 1 


T, W, F, C 


'W or 2 


W, F, C 


'F' or 3 


F, C 


'C or 4 


C 



SM5END 

The SM5EOT) procedure terminates your sort or merge 
specification and initiates Sort/Merge processing. 
SM5END must be the last procedure you call . The SM5END 
procedure format is shown below: 

CALL SM5END 



SM5ENR 

The procedure SM5ENR specifies the estimated number of 
records to be sorted or merged. If you do not call 
SM5ENR, a value of 80000 divided by the value specified 
for the maximum record length (MRL) is used. The 
SM5ENR procedure format is shown below: 

CALL SM5ENR( integer) 

Integer Number of records to be sorted or 
merged. The range is to 1000000000. 



SM5FAST 

Th4 SM5FAST procedure specifies that certain sort or 
merge input and output operations are to be performed 
directly by Sort/Merge rather than by CRM. If the 
option is YES, the records must be BT=C and RT^F, or 
BT=I and RT-W. If the option is NO, CRM Is used. If 
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you omit SM5FAST, the default Is SM5FAST-'YES' 
SM5FAST procedure format Is shown below: 

CALL SM5FAST(optlon) 

option The option can be: 
'YES' or 'Y', 
'NO' or 'N' 



SMS FROM 

The SM5FR0K procedure specifies the Input files from 
which the records to be sorted or merged are read. You 
can specify up to 100 files with each SM5FR0M or you 
can call SM5FR0M up to 100 times. The files are read 
In the order you specify them. If you do not call 
SM5FRDM, the default file Is OLD (unless an owncode 
routine supplies records). The SM5FR0M procedure 
format Is shown below: 

CALL SM5FR0M('fllel'[,'flle2']...) 

'file' File name; one to seven letters or 
digits, beginning with a letter. 



SM5KEY 

The SM5KEY procedure specifies a single key field for 
the sort or merge. You can call SM5KEY as many as 100 
times during a sort or merge. The total number of key 
characters you can use must be less than 255 characters 
(if you also specif ly sum fields, the total number of 
characters in the key and sum fields together must be 
less, than 256). If you do not specify SM5KEY, the 
entire record Is used as a character key field and the 
default key type and sort order are used. The SM5KEY 
procedure format is shown below: 

CALL SM5KEY(flrst, length, 'type' , 'ad') 

■first First byte or bit of the key field; 
the leftmost byte or bit is counted as 
number 1. 

length Number of bytes or bits In the key 
field. 

'type' Name of a numeric data format or 
collating sequence. 

'ad' Order; either 'A' for ascending or 'D' 
for descending. 
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SM5MERG 

The SM5MERG procedure signals the beginning of a merge 
specification. SM5MERG must be the first procedure you 
call for a merge. The result array is a 16-element 
integer array; each element returns a result as shown 
in table 10. You set the first element before calling 
the procedure. The SM5MERG "procedure format is shown 
below: 

CALL SM5MERG(option) 

option Result array name; one to seven 
letters or digits, beginning with a 
letter, or the integer zero, The 
integer zero returns no statistics or 
results. 



SM50FL 

The SM50FL procedure specifies the exact number of 
characters in each fixed length record entering the 
sort from an owncode routine. If you do not specify 
SM50FL, the records can be no longer than the longest 
allowed input or output record. You cannot call SM50FL 
and SM50MRL in the same sort. The SM50FL procedure 
format is shown below: 

CALL SM50FL( integer) , 

integer Exact number of characters in each 
fixed length record entering the sort 
from an owncode routine. 



SM50MRL 

The SM50MRL procedure specifies the maximum length of 
any record entering the sort from an owncode routine . 
If you do not call SHSOMBL, records entering the sort 
from an owncode routine can be no longer than the 
longest allowed input or output redord. You cannot 
call SM50MRL and SM50FL In the same sort. The SM50MRL 
procedure format is shown below: 

CAIi SM50MRL( integer) 

integer Maximum length in characters of any 
record entering the sort from an 
owncode routine. 
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TABLE 10. RESULT ARRAY FORMAT 



Array 
Element 
Number 


Contents 


1 


Number of elements of results you want 
returned (0 through 15) 


2 


Number of records read from sort or merge 
input files 


3 


Number of records deleted by an owncode 1 
routine 


4 


Ntnuber of records inserted by an owncode 1 
routine 


5 


Number of records inserted by an owncode 2 
routine 


. 6 


Number of records sorted or merged 


7 


Number of records deleted by an owncode 3 
routine 


8 


Number of records inserted by an owncode 3 
routine 


9 


Number of records inserted by an owncode 4 
routine 


10 


Reserved 


•11 ■■ 


Number of records deleted by an owncode 5 
routine 


12 


Number of records combined by summing 


13 


Number of records written to Output file 


14 


Minimum record length in characters; 


15 


Average record length in characters 


16 


Maximum record length in characters 
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SMSOWNn 

The SMSOWNn procedure specifies an owncode routine that 
executes each time point n is reached during the sort 
or merge. If you do not specify SMSOWNn, no owncode 
routine executes. The SMSOWNn procedure format is 
shown below: 

CALL SM50WNn(proc) 

n Point at which the owncode routine is 

executed; must be a 1» 2, 3, 4, or S. 
See the section on Owncode Routines 
for more detailed information, 

proc Owncode routine name ; one to seven 
letters or digits, beginning with a 
letter. In a FORTRAN program, the 
name must be declared in an EXTERNAL 
statement. 



SMRETA 

The SMRETA procedure specifies that records with equal 
sort keys are output In the same order as they are 
Input. If you do not call SM5RETA, records with equal 
keys might not be retained In the original order. The 
YES option assures that records with equal keys retain 
their original order. The SMRETA procedure format Is 
shown below: 

CALL SMEETA( option) 

option The option can be: 
'YES' or 'Y', 
'NO' or 'N'. 



SMSSEQx 

The SMSSEQx procedure specifies a user-defined 

collating sequence that Is referenced by SM5KEY. 

SMSSEQx specifies something different about the 

collating sequence depending upon x. The x can be N, 
S, R, or A. 

The SM5SEQN procedure names the collating sequence. It 
must be the first called In the series of SMSSEQx 
procedures. The procedure format is shown below: 

CALL SMSSEQN('name') 
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'name' Collating sequence name enclosed In 
apostrophes; 1 to 31 letters, digits, 
or the special characters ? ^ ^ _^ 
(only the first 10 characters are 
significant and the first character 
must be a letter). It also must be a 
different name from any predefined 
collating sequence. 

The SM5SEQS procedure assigns collating positions to 
the characters in your collating sequence. Each 
SM5SEQS procedure specifies a value step in the 
sequence. A value step consists of one or more 
characters. Characters specified in the same step 
collate equally. This procedure can be called more 
than once. The procedure format is shown below: 

CALL SM5SEQS ('char' ,.,., 'char' ) 

'char' Character in the collating sequence. 

The SM5SEQR procedure assigns equal collating position 
to characters not specified by SM5SEQS. The procedure 
format is shown below: 

CALL SM5SEQR('YES') or CALL SM5SEQR('Y') 

The SM5SEQA procedure alters characters in the same 
value step to output the same as the first character in 
the step. The procedure format is shown below: 

CALL SM5SEQA('YES') or CALL SM5SEQA('Y') 



SM5S0RT 

The SM5S0RT procedure signals the beginning of a sort 
specification. SM5S0RT must be the first procedure you 
call for a sort. A 16-element integer array returns 
results of the sort back to your program; each element 
returns a result as shown in table 10. The first 
element in the array is set by you, before calling the 
procedure. The SM5S0RT procedure format is shown below: 

CALL SM5S0RT(option) 

option Result array name ; one to seven 
letters or digits, beginning with a 
letter, or the integer zero. The 
integer zero returns no statistics or 
results. 
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SM5ST 

The SM5ST procedure specifies an integer variable that 
is set to a value representing the highest level of 
error that occurred during the sort or merge. Table 11 
shows the error levels and the representative values. 
If you call the SK5ST procedure, Sort/Merge does not 
abort if a catastrophic error occurs before any data 
records are input. Some types of errors do not allow 
recovery and an abort can occur regardless of the SM5ST 
procedure. The SM5ST procedure format is shown below: 

CALL SM5ST(variable) 

variable Symbolic name of an integer; one to 
seven letters or digits, beginning 
with a letter. 



TABLE 11. ERROR LEVEL CODES 



Error Level 


Code 


No Errors 





Trivial 


10 


Warning 


20 


Fatal 


30 


Catastrophic 


40 



SM5SUM 

The SM5SUM procedure specifies fields that are to be 
summed in records with equal key values. As many as 
255 bytes can be summed. The Sort/Merge summing 
procedure combines records with all key fields equal 
into one new record and deletes other records with 
equal keys. The SM5SUM procedure format is shown below: 

CALL SM5SUM (f irst, length, 'type' , rep) 

first First byte or bit of the sum field 

length Number of bytes or bits in the sum 
field 
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'type' Name of a numeric data format 

rep Number of fields to be summed 

You can call SM5SUM as many as 100 times during one 
sort or merge. You cannot call SM5SUM and SM50WN5 in 
the same sort or merge. 



SM5TO 

The SM5T0 procedure specifies the file to which sorted 
or merged records are written. If your program also 
reads or writes the file, you must include an OPEN or 
REWIND statement in your program after calling the 
procedures. If you do not call SM5T0, records are 
written to file NEW (unless an owncode routine 
processes all records). The SM5T0 procedure format is 
shown below: 

CALL SM5T0('file') 

'file' File name; one to seven letters or 
digits, beginning with a letter. 
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COBOL INTERFACE 

You can use Sort/Merge 5 from COBOL 5 through a control 
statement option or through direct calls. If you 
specify SORTS in your COBOL 5 control statement, 
Sort/Merge 5 is used when the SORT or MERGE statement 
in your COBOL program executes . See the COBOL 5 
reference manual for information on coding the SORT or 
MERGE statement in a program. 

Direct calls from your COBOL program to the Sort/Merge 
procedures, can be made with the ENTER FTN5 SM5xxx 
statements. See the COBOL 5 reference manxial for 
information on coding ENTER statements. 
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OWNCODE ROUTINES 

You can write a routine to insert, substitute, modify, 
or delete input and output records each time the sort 
or merge processing reaches a certain point. The 
owncode routines are written in FORTRAN, COBOL, or some 
other language that has been compiled and saved in 
relocatable binary form. 

Specify the OWNF parameter when you are using control 
statement calls to Sort/Merge. The OWNF parameter 
supplies Sort/Merge with the name of the file 
containing your owncode routines. The OWNn parameter 
specifies the name of your owncode routines . 

Specify SMSOWNn when you are using procedure calls to 
Sort/Merge. SM50WNn specifies the name of your owncode 
routine and indicates at which point in processing the 
routine is executed . 

Owncode routines are called with parameters, as shown 
in the SUBROUTINE format in figure 1. A summary of the 
owncode routines and the parameters passed by each 
routine is shown in table 12. 



SUBROUTINE proc(return code, reca,rlaC,recb, rib]) 



proc Procedure name 

return_code Parameter passed by Sort/Merge that 

can be changed by the owncode routine. 
The value returned to Sort/Merge indi- 
cates a specific action to be taken by 
Sort/Merge. 

reca Parameter that is an otherwise empty 

array that is used to pass the current 
record. 

rLa Parameter that passes the number of 

characters in the current record being 
sorted or merged- 

recb Parameter used when processing two 
records with equal, keys; passes the 
second record. 

rib Parameter used when processing two 

records with equal keys; passes the 
number of characters in the second 
record. 



Figure 1. Subroutine Format 
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TABLE 12. OWNCODE ROUTINE SUMMARY 



Routine 
Type 




Parameters Passed 






Processing 








Return_code Value 


Return code 


reca 


rla 


recb 


rib 


Owncode 1 


Input records 


X 


X 


X 








1 

2 
3 


Sort current record. 

Delete current record. 

Insert new record. 

Terminate input from 
current file. 


Owncode 2 


Input files 


X 


X 


X 








1 


Begin processing next 
input file. 

Insert new record. 



TABLE 12. OWNCODE ROUTINE SUMMARY (Contd) 



Routine 
Type 


Processing 


Parameters Passed 


Return_code Value 


Return code 


reca 


rla 


recb 


rib 


Owncode 3 

Owncode 4 
Ovmcode 5 


Output records 

Output files 
Equal keys 


X 

X 
X 


X 

X 

X 


X 

X 
X 


X 


X 


Modify current record. 

1 Delete current record. 

2 Create new record. 

3 Terminate output. 

Sort or merge is com- 
plete . 

1 Insert new record. 

Retain both records. 

1 Replace both records with 
new record. 
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